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This document describes a set of routines which have been provided at both 

the monitor and user level to facilitate the following operation*: 

1) Vidissector input; 2) Pot box input; 3) Am motion; 4) Display list 

generation. 



This program was developed under contract with 
Systems Concepts, Incorporated 
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1. MONITOR ROUTINES 

Vldlaaector Control Routine! .VSCAK) 

The ITS routine which is used to do the actual box scan U able to do 
perspective as well as nonperapective input. The system call to initiate 
a scan is as follows: 

.VSCAH PTABLE 



PTABLE is an ll in word array which contains the information required for 
performing the scan. The format of each word of the table id described 
below: 



CONTROL BITS^VIDISSECTOR CONO 

At present only one control bit is used. This bit (4,9) determines 

whether or not the job should wait for the scan to complete. If the 

bit is 0, no wait occurs and job is allowed to proceed and the 

interrupt routine handles the actual scan. 

-COUNT, , ARRAY 

This is an AOBJV pointer as explained in the description of +VSCAN. 

X RESOLUTION, f Y RESOLUTION 

Each 18-bit Integer quantity gives the number of point* to be scanned 

on the specified axis. 

The format of the following values is: 

INTEGER PART, , FRACTIONAL PART 
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Rl 


U. 


R2 


5. 


CI 


6. 


B3 


7. 


R4 


8. 


C2 


9. 


PI 


iO. 


P2 
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The above parameters arc then used to compute the actual (X,Y) 
position of a scan point on the vidlssector. The actual equations and 
method can best be explained by an ALGOL routine. 

FOR Yl+O STEP 1 UNTIL YRES-1 DO 
BEGIN 

FOR X1*0 STEP 1 UNTIL XRES-1 00 
BEGIN 

Y2*-(2*Xl+i) / (2*XRES) 
TEHF+P 1*X2+P2*Y2+1 
X+<R1*X2+R2*Y2+C1)/TKMP 
Y«-< R3*X2+R4 *Y2+C2 ) / TEMP 
ARRAY (Y1*XRES+X1)*SCAN(X T Y) 

END 
END 









The .PQTSET call 

I 
This call gives the u*er a flexible means of controlling program 

parameters via the Input multiplexor. A maximum of 20 simultaneous 

connections between pots and variables Is permitted- Each may be variable 

fixed or floating point. If fixed point. It may be an arbitrary byte 

within a word. The user may specify a mapping from pot values to variable 

values by giving an upper and lower limit. These may be inverted to give 

a backward mapping. Two types of control are provided, absolute aod 

incremental. In absolute mode, the true pot position sets the value. Ibis 

may be useful for positioning displayed objects with a joystick. The 

incremental mode permits a variable or set of variables to be changed 

slightly without causing a discontinuous jump In their values. The value 

is unchanged at connect time, but rotating the pot adds its scaled increment 

to the variable. Turning it down in the bottom third, or up in the top 
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third of the pots range cause© a faster change so as to keep the control 
near center* The increase in gain is inhibited at Low speeds to prevent 
drift due to noise* 

The address of the call points to a table of pot connection dpeclf- 
ications. This table consists of up to 20 blocks of 4 words, followed by 
a word. The block format is as follows: 

F00/ Multiplexor channel. .control bits 

F00 + 1/ Byte spec* variable address 

F00 + 2/ Lower limit (value at pot ■ 0) 

FO0 + 3/ Upper limit (value at pot - 10000) 

Control bits: 

2.9 ■ delete only (if disconnect previous use of pot, no new 

attachment) 
1.2 ■ absolute if 0N T incremental If OFF 
1.1 - floating if ON. fixed if 0PP. 

Byte Spec: 

= full word; standard byte pointer format for partial word 

(no index or indirect allowed). 

The following program will display a 45 degree vector of 177 on the 
scope and permit moving its origin with pots 142 (V) and 143(X). 

BEG: .P0TSET PTBL 

.D5TAHT [-3»DTBL-1J 
•VALUE 
.VALUE 
PTBL: 142„0 ; CHAN162.FIXED M\. INCH, 

221200,, DTBL + 1 ; Y FIELD OP PT J»DE WORD 

200 ; VECTOR GOES 177 BELOW AND LEFT 

OF ORIGIN 
177 * ; TOP OF SCOPE 

143, ,0 , ; CHANU3.FIXT FT-, IKCR. 
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1200., DTBL + 1 


• 


200 


• 


1777 







i 


DTBL: 20117 


* 


221000,, 101000 


* 


777777, ,3000 


i 


l:.e .AKMOVE call 





X FIELD OF FT MODE WORD 
LOWER LIMIT X 
UPPER LIMIT X 
END . POTSET TABLE 
TO PT- MODE, SCALE INTENSITY 7 
START AT MIDDLE OF SCOPE, TO 
VECTOR MODE 
; ESCAPE, IKTENS, DX-DY- -177.STOP 



SERVO routines have been incorporated into the ITS Monitor. These 
routines provide acceleration and velocity limiting, software position 
limit stops, conversion from Joint number to multiplexor channel, and 
some other utility functions. The user consnunlcates with the SERVO 
routines by a series of one word coeoaands. A block of commands is 
transmitted to the system at one time with a non-interruptible call as 
follows: 

HOVE A,[-N>,AKHBLK] 
.ARMOVE A, 



This will Interpret ARMBLK through ARMBLK+M-1 
word formatted as follows: 



as SERVO commands with each 



4.9-4.* 


JOIST NUMBER 


4. 3-3.7 


COMMAND 


3.6 


UNUSED 


3.5 


INDIRECT 


3.4-3.1 


INDEX 


2.9-1.1 


ADDRESS OR OPERAND 



The currently available joint addresses are: 
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D - 


AMF SWING 


1 - 


AMF VERTICAL 


Z - 


AMF HORIZONTAL 


3 - 


AMF YAW (INOPERATIVE) 


& - 


ALLES HAND TILT 


5 - 


ALLES HAND GRIP 


6 - 


ALLES HAND ROTATE 


7 - 


ALLES HAND EXTEND 


10 - 


AMF ROLL (INOPERATIVE) 



The currently available commands are: 

- SET DESTTKAXIOW 

1 - SET VELOCITY LIMIT 

■ 

2 - TEST MAGNITUDE OF POSITION ERROR 

3 - TEST MAGNITUDE OF VELOCITY 

The operand is computed by adding the contents of the specified INDEX 
roister <i£ XMO) to the right half of the command. The result ia masked 
to 18 bits. If the indirect bit is 0!*, the right half of the word addressed 
Is used as the operand. No further indexing or indirecting Is interpreted. 

The test comaands are "TRUE" if the quantity tested exceeds the operand. 
If any tests are "TRUE" the .ARMDVE will skip. The SERVO routines are 
activated by the first .ARHOVE and are turned off by a .ARMOFF or killing the 

job. 

A .ARMOVE is illegal if {1} the arm is in use by another user, (2) the 
block extends above the user's laetaory bound, (3) an indirect reference i* 
out of bounds, (4) an unused conmand code or Joint number is specified, or 
(5) the block is over 100 words long. 
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2. USER LEVEL ROUTINES 

Vidissc-ztnr Scan Routine 

In oruer to facilitate the nouperspective use of ITS VIDISSECTOR SCAN 
ROUTINE (,VSCAN), a user routine has been provided to set up the input 
parameter* for a box scan. This routine has the following call sequence: 

MOVEI R.PARAM 
PUSKJ P.VSCAN 

PARAM is the address of a word table. Hie format of this table and 
the meaning of each entry is as follows: 
NOTE: All elements except the first are in floating point format. 

0. -SIZE,, DATA ARRAY 

This Is an AOBJN pointer to the array where vidlssector data should 
be stored. If the size specified for the array is too snail to hold 
the requested data an error will occur and the vldlssector will not 
be started. 

1. X CENTER 

2. Y CENTER 

Indicates the center position of the scan in vidissector coordinates* 

3. X SIZE 

4. Y SIZE 

Indicates the size of the box to be scanned in vidissector coordinates. 
5- X RESOLUTION 
6* Y RESOLUTION 

Gives the number of points to be scanned on each axis of the box. 

7 . ROTATION 

Gives *:he rotation of the box in radians. 

8. SKEW 

Gives the skew of the box in radian*- 



Arc Control 

As a means of simplifying user control over the arm, an Interface 
routine is provided between the user and th© system. This routine is 
called in the following way: 

M3VEI R.ATABLE 
PUSHJ P,WAVER 

ATABLE is an array of new arm/hand position values. Ac present 
only 6 motions can be specified. (For purposes of simplicity, the band 
is always kept pointing straight down). The user, when requesting motion, 
specifies the location (X,Y»2) of the center of the grlppsr, as well as 
the orientation (rotate and tilt) of the hand and spread of the "claw." 
The base of the X,Y,Z coordinate syaten Is assumed to be on the floor in 
the center of the swing axis. The axis are as shown below: 




It should be pointed out that because of the geometry of the arm, 3 
change in X,Y will cause a change of $ since an attempt is made to keep 
the proper orientation of the hand. If a user specifies a position outside 
the limit specified for the axis, the position will peg at the relevant 
limit. In addition, a null motion is represented by a word of all ones 
where the new position value is normally found. The current routine has 
two additional features; 

1. An attempt is made to have all requested motions complete at the same 
time. 

2. The WAVER subroutine returns to the user as soon as all motion has 
been started * The user can cause his program to wait for the arm 
motion to complete by doing a PUSBJ to the WVWA1T routine. Correspond* 

ingly, a change in tilt will cause corrections In the vertical and horiz- 
ontal position so that the center of the "claw" will remain at the same 
point. 

Displ ay Hon tings 

This package allows a user to build a display list which may consist of 
any of the following elements: 

1, Control Information I 

■ 
a* Intensity sotting 

b. Scale setting 

2, Point Display 

3- Character Display 
4, Vector Display. 

The code is constructed in such a way that a user can either call a 
standard set of routines which perform the most commonly requested tasks, 
or else he can build his own special purpose package using the sane basic 
primitives as does the standard package. 
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It should be noted that various routines use some or all of the 
registers W,VW,£Z without restoring their original value**. A good 
general rule is to not expect any of these registers to be preserved after 
a call to the display package. In addition, certain of the functions 
use other registers and this will be pointed out in the individual descrip- 
tions* 
Initializing the Display Pqckap.fi * 

TTie first thing that roust be done Is to Ufllgn a buffer Co the display 
package and initialize its state. 

Tlii* ift accomplished by the following sequence; 

MOVE W, (MJFFEK START, .BUFFER END] 
HOVEL WW.ERROREXIT 
PUSH J P.DSPRST 

Register W must contain a pointer to the start of the buffer (in the 
left half) and a pointer to the last element of that buffer (in the right 
half). 

Register WW must contain an address to be transferred to if the 
buffer should become full while generating the display list. 

Upon returning from DSPLtST, the "DISPLAY" will be in parameter mode, 
the scale will be 0. and the size will be 7. At this point the user is 
ready to generate displays. 

DisplayMcdes 

■ 

The current package is capable of putting the display in any one of 
four modes* This can be accomplished by a PUSHJ to an appropriate routine. 

The modes and the proper routine used to place the display in that 
mode are as follows: 
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1. 


Par. meter 


2. 


Point 


3. 


Character 


4, 


Vector 



Hogg Mode Setting Routine 

MODPRM 
MODPNT ' 
MODCHR 
HODVEC 

If the "DISPLAY" was already In the node requested, nothing happens. 
In all other cased, any necessary clean up is performed before the mode is 
actually changed. 
Parameter Mode Oper ations MODPRM 

" i 

Two routines arc provided for the express purpose of adjusting these 
quantities. It should also be noted that these routines make sure that the 
"DISPLAY" is in parameter mode* 

Intensity , The calling sequence for an intensity change in: 

MOVEI W, HtV INTENSITY * 

PUSHJ P,DSPBRT 

Scale . The calling sequence for a scale change is: 

MOVEI V, NEWSCALE*4 
PUSHJ P.DSPSCL 

For example: 

if (W) = 20 8 

the new scale is 1. 

It should be poluted out that Lf the new scale or Intensity i* the sane 
as the current value, the operation Is a no-op. In addition, tf the "P15P1.AY" 
is currently in parameter mode, no additional half-words will be added to the 
display list- 

Point Mode 



In order to allow the same routines to be used for both positioning 
as well as displaying, the register Z controls itensifications: If (2) ■ 0, 
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the cisplay is positioned to the coordinates requested, but no intensification 
occur*. However, when (Z) = 2000, the poitlt is displayed. MOTE: Any other 
value in Z will cause randomness. 

The possible entry points and their meaning are as follows: 

The desired position is found in X and Y as floating 
point values* Registers A, B, C, are altered and not 
restored. 

Desired position is found In 8 and C as fixed point numbers. 
Same as above, except display is aasuaed to be in point Mode* 
This* entry la useful (aud also slightly »ore efficient) when 
displaying a sequence of points. 

NOTE : All values used by the routines mentioned above are 
truncated to 10 bits. 



DSPFLT 



D5FPNT 
DSPPTU 



Character Mode 

Ttoo routines are provided for displaying characters: 

DSPCHR Displays a character at the current X t Y position* 

The character to be displayed is found in W, 

DSPTXT Displays a text string, produced by the A5CIZ 

pseudo-op starting at the moat recent coordinates. 
A byte pointer to the string aliould be in W. 

D5PM5G Positions the display to the location specified in 

B and C (as fixed point coordinate valued) and then 
displays a nessage as described in D5FTXT* 

Both the DSPTXT and DSPMSG routines destroy the current content* of 
register A. 
Vector Display • 

The entry point for displaying a vector is DSPVEC. The registers 
B and C contain the values AX and AY, respectively, with the current 
position of the display being used as the starting point on the vector* 



I 



■ 
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Registers A,B t and C are destroyed by this routine. 
Putting Arbitrary Commands into the Display 

Although great care should be exercised In putting commands directly 
into the buffer, this facility is available through the routine D5PPUT, 

This is accomplished by putting 18-blt value to be placed in the buffer 
Into register W and calling D5PPUT* NOTE ; Since no check Is made « the 
input at chid point, it is up to the user to inak.e sure the display in In the 
proper node. 

Terminating the Display. List 

When a desired display list has been completely generated it oust be 
terminated so that it can be displayed on the scope. This is accomplished 
by the routine DSPSTT. No arguments arc transmitted* but a BLKO pointer 
to the current display list is returned in register W. This pointer can be 
passed to the system display processor (.DSTART) directly or it can be added 
to a list of BLKO pointers and then passed to the system as a part of the list 



C0H3ECTI0S TO PAGE S 

Before The .ABMOVE call , after the program on Page 5 read: 

Not* time the program does not need to be running to move the line on 
the scope. The .POTSET call Is Illegal if either 1) the user tries CO 
connect a pot already in use by anocher user, 2) the table is more than 
twenty block* long, 3) twenty pots are already connected, or 4) the 
address exceeds tha user's memory bound. A pot is disconnected when 1) 
the user disconnects it with « -POTSET, 2) the user reduces hi. memory 
bound below the address the pot controls, or 3) the job Is killed. 



